home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / comm / mmgr / MM_StarTrack.lha / MM / Docs / MM_StarTrack.doc < prev    next >
Text File  |  1996-10-09  |  47KB  |  1,537 lines
  1.  
  2.  
  3.  
  4.  
  5.                                   L   L  L   L
  6.                                   LL LL  LL LL
  7.                                   L L L  L L L
  8.                                   L   L  L   L
  9.                                   L   L  L   L
  10.  
  11.  
  12.            LLL   LLLLL   LLL   LLLL   LLLLL  LLLL    LLL    LLL  L  L
  13.           L        L    L   L  L   L    L    L   L  L   L  L     L L
  14.            LLL     L    LLLLL  LLLL     L    LLLL   LLLLL  L     LL
  15.               L    L    L   L  L  L     L    L  L   L   L  L     L L
  16.            LLL     L    L   L  L   L    L    L   L  L   L   LLL  L  L
  17.  
  18.  
  19.                              L   L  LL     LL   LL
  20.                              L   L L  L   L  L L
  21.                              L   L L  L    LLL LLL
  22.                               L L  L  L      L L  L
  23.                                L    LL  L  LL   LL
  24.  
  25.  
  26.  
  27.  
  28.                           (C)  1994-96  Robert Hofmann
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  1. Introduction
  35.  ===============
  36.  
  37.   1.1 Legal stuff
  38.   ---------------
  39.  
  40.    MM_StarTrack is a full localised  Message-Tracker for  Mail Manager (c)  Pino
  41.    Aliberti, generally used only on node-systems.
  42.  
  43.    The programs and files in this distribution are freely distributable, but are
  44.    also Copyright (c) Robert Hofmann.  They may be freely distributed as long as
  45.    no more than a nominal fee is charged to cover time and copying costs.
  46.  
  47.    No commercial usage is  permitted without written permission from the author.
  48.    Everything in this distribution must be kept together, in original unmodified
  49.    form and unmodified archive.
  50.  
  51.  
  52.    MM_StarTrack  is mailware :-). This means if  you use it longer that 30 days,
  53.    you have to  register (see also 1.3). YOU HAVE TO  PAY  *NOTHING*!!! You only
  54.    have to send me a mail.
  55.  
  56.    Due to that,  MM_StarTrack will  automatically  monthly  notify me if you are
  57.    using it longer  than 30 days. The only  difference of the reg. to the unreg.
  58.    version is that the reg. version will *NOT* send notification-msgs to me (see
  59.    also 1.3)!
  60.  
  61.    Also MM_StarTrack will automatically report ARexx-errors, which may occur due
  62.    to an error in my  code (which hopefully will never happen :-) as  netmail to
  63.    my AmigaNet- or FidoNet-addresse, together with your cfg-file.
  64.  
  65.  
  66.  
  67.    Accepting these few  points is the only  condition for using  MM_StarTrack...
  68.  
  69.  
  70.    If you  are not able to agree with  these conditions, you  *MUST* *NOT* *USE*
  71.    this program!!!
  72.  
  73.  
  74.  
  75.    ============================================================================
  76.    The author is not responsible for any problems caused by using this program!
  77.    ============================================================================
  78.  
  79.  
  80.  
  81.    ****************************************************************************
  82.    WARNING: DO NEVER MODIFY  THE SCRIPT!  THIS  COULD END IN  THE LOOSE OF NET-
  83.             MAILS IF YOU DON'T EXACTLY KNOW WHAT YOU ARE DOING!!!
  84.             IF THERE IS A  PROBLEM, PLEASE  REPORT IT  TO *ME*, SO THAT *I* CAN
  85.             FIX IT!
  86.    ****************************************************************************
  87.  
  88.  
  89.  
  90.  
  91.  
  92.   1.2 General stuff
  93.   -----------------
  94.  
  95.    Nearly  all should be configurable as  you like it,  but of course you should
  96.    know what you are doing, 'cause it's a msgtracker :-)
  97.  
  98.    I am not the best in  writing doc, but quiet good  in coding I think :-) This
  99.    docs are a bit  short I have to  appolognize, but I hope you'll understand it
  100.    anyway... Especially my English and the typo's ;-)
  101.  
  102.  
  103.  
  104.   1.3 Registration of MM_StarTrack
  105.   --------------------------------
  106.  
  107.    Since v0.85, you  now can register  your copy of  MM_StarTrack. This was done
  108.    because some people complained about the notification-mails.
  109.  
  110.    BUT YOU HAVE *NO* DISADVANTAGES IF YOU DO NOT REGISTER! The unreg. version is
  111.    *NOT* crippled!!!
  112.  
  113.    The only  difference  between the  reg. and the  unreg. version  is  that the
  114.    unreg. version starts to send  me  notification-mails  after 30 days of usage
  115.    and all further 30 days.
  116.  
  117.  
  118.   1.3.1 Notification-mails
  119.   ------------------------
  120.  
  121.    The notification-mail  (see Examples/Notification.mail) is automatically sent
  122.    by MM_StarTrack if the evaluation-period of 30 days has expiered.
  123.  
  124.    This mail consists of some infos  about your system: your statistic-file, no.
  125.    of addresses, domains, mailareas you use, size of MM_StarTrack.cfg & MM_Star-
  126.    Track.rexx.
  127.  
  128.    As you can see, no critical informations will be sent, it is just to see what
  129.    kind of system you have.
  130.  
  131.    If you  don't like that, and you disable this function or you stop that mail,
  132.    YOU ARE  NOT ALLOWED TO USE MM_StarTrack on your system! Please consider that
  133.    you can register to prevent these mails and that I want no money...
  134.  
  135.  
  136.   1.3.2 How to register?
  137.   ----------------------
  138.  
  139.    If you find this programm usefull and you want to use it longer that 30 days,
  140.    you should register.
  141.  
  142.    You need not pay any money for it, but it would be nice if you do so. :-)
  143.  
  144.    This can be easily  done by using  Reg_StarTrack.rexx, which  you can find in
  145.    the Rexx-dir of this release.
  146.  
  147.    Make sure that MM is running and just type "rx <dir>/MM_ST_Registration". Now
  148.    you will be asked about some datas. If all was ok, the registration-mail will
  149.    be written in your mailarea. Please check it and if all is ok, you can export
  150.    the message.
  151.  
  152.    As soon as your reg. mail  arrives here, I will  generate a  personal keyfile
  153.    for you which will only work on *YOUR* system! The key will be send uuencoded
  154.    via netmail.
  155.  
  156.    If you receive the key, you only  have to uudecode it, copy  it to MM:Config/
  157.    MM_StarTrack/, named  MM_StarTrack.key. After you have  done this, please run
  158.    MM_StarTrack  with option  CPLCFG  ("rx MM:Rexx/MM_StarTrack.rexx CPLCFG") to
  159.    personalize your copy of MM_StarTrack.
  160.  
  161.    That's all.
  162.  
  163.  
  164.  
  165.   1.4 Author
  166.   ----------
  167.  
  168.    If  you  have  suggestions  or remarks about this program, or if you find any
  169.    bugs, please let me know.
  170.  
  171.  
  172.    Contacting the author:
  173.  
  174.      Internet .. :  robert@next.amistep.osn.de (soon!)
  175.      FidoNet ... :  2:2490/1015.0   (may change soon!)
  176.      AmigaNet .. :  39:171/101.0
  177.  
  178.      Snail-mail  :  Robert Hofmann
  179.                     Volkmannstr. 35
  180.                     D-90443 Nürnberg
  181.                     Tel. +49-(0)-911-9941680 (18-20h German time only!!!)
  182.                     Germany
  183.  
  184.      Bank-Account:  Account-holder:  Robert Hofmann
  185.                     Account-number:  67920
  186.                     Bank-ID ..... :  76090000
  187.                     S.W.I.F.T.code:  GENO DE MV 760
  188.                     Bank-name ... :  Volksbank Nuernberg e.G.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  2. Features
  195.  ===========
  196.  
  197.   MM_StarTrack...
  198.  
  199.      ... is not  so easy to configure ;-) but all  parts can be  set as YOU want
  200.          them!
  201.      ... is domain-sensitive
  202.      ... is able to detect netmail-loops & inform the involved systems
  203.      ... is able to Return-Receipt-Requests, even for points!
  204.      ... is able to detect and bounce or delete twit-netmails
  205.      ... is able to detect and bounce or delete crossnet-netmails
  206.      ... is able to detect and bounce (even splitted) encoded mails
  207.      ... is able to detect, bounce & hold FileAttachs
  208.      ... is able to forward mails of unknown senders
  209.      ... is able to delete empty mails
  210.      ... is able to log netmails
  211.      ... is able to execute (multiple) command(s) for every received netmail
  212.      ... is able to forward configured msgs to another person or echo
  213.      ... is fully localized
  214.      ... is (fully?) documented ;-)
  215.      ... offers a bad-netmails area
  216.      ... offers you a very powerful remapping, even with wildcards!
  217.      ... keeps statistics about processed mails
  218.      ... has an advance fileattach-handling
  219.      ... has an advanced config-reading-mechanism (<< 1 sec!)
  220.      ... and (maybe?) many more things ;-)
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  3. Installation
  227.  ===============
  228.  
  229.   1. Create a drawer MM:Config/MM_StarTrack
  230.  
  231.   2. Copy the files to the corresponding MM:#?/-directories.
  232.  
  233.   3. Set the mail-areas where it should  be active to "TwoPassImport", otherwise
  234.      it never can process any msg because they immediatly will be routed by MM.
  235.  
  236.   4. Add it to your import-batch (or aftersession-batch) like
  237.  
  238.      [...]
  239.      rx mm:rexx/MM_Import
  240.      rx mm:rexx/MM_StarTrack
  241.      rx mm:rexx/MM_AreaManager
  242.      [...]
  243.  
  244.      or even better, use MM_ImportPlus and add it to its cfg like
  245.  
  246.      #NETMAILCMD   rx mm:rexx/MM_StarTrack
  247.      #NETMAILCMD   rx mm:rexx/MM_AreaManager
  248.      [...]
  249.  
  250.   5. Set up an address for you called 9999:9999/9999.9999@badnet
  251.      (#ADDRESS  9999:9999/9999.9999@badnet  0)
  252.  
  253.   6. Set  up a node called  9999:9999/9999.0@badnet,  addressing 5D, packets 5D,
  254.      flavour HOLD.
  255.      (#NODE 9999:9999/9999.0@badnet ADDR5D PACK5D HOLD HOLD LHA)
  256.  
  257.   7. Add 9999:9999/9999.0@badnet as last  line in your routing, so that all mail
  258.      which was not affected by your current routing will be SEND as HOLD to this
  259.      node.  If you want  that it  will  work properly,  you have to  use  global
  260.      routing  statements for a  network like  (1|2|3|4|5|6):#?/#?.#?@#? for your
  261.      main (in this case FidoNet-) uplink.
  262.      (#ROUTING #?:#?/#?.#?@#? ALL SEND 9999:9999/9999.0@badnet HOLD)
  263.  
  264.   8. Create a  MAIL-area for bad  netmails called  e.g. BAD_NETMAILS and set its
  265.      address to 9999:9999/9999.9999@badnet
  266.      (#MAILAREA "Bad Netmails" BAD_NETMAILS Areas:BAD_NETMAIL/ 9999:9999/9999.9999@badnet DUMMY 100
  267.       ReadOnly
  268.       etc..)
  269.  
  270.   9. Adjust the cfg-files to your personal  needs. If there are no text-files in
  271.      your language, please  translate them and send  a copy to me, so that I can
  272.      include them in a future release (address see somewhere below).
  273.  
  274.  
  275.   Asy you may have seen, there is a second script called "MM_StarTrack.rexx.cmp"
  276.   included. This  is a exacltly  the same script  as "MM_StarTrack.rexx" itself,
  277.   except that it was compressed with "Compress.rexx v2.1".
  278.  
  279.   On slow machines, it  might be useful to  replace the uncompressed script with
  280.   the  compressed one because it is slightly faster... But  please test it first
  281.   with the uncompressed  version, because if an error occurs,  finding the error
  282.   due to error-reports of the compressed script is nearly impossible!
  283.  
  284.   If you really want to use  the compressed script, you  have to REPLACE the un-
  285.   compressed script with the compressed  one! The used script MUST exactly named
  286.   "MM:Rexx/MM_StarTrack.rexx", otherwise it will not work!
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  4. Usage
  293.  ========
  294.  
  295.   [RX] MM_StarTrack[.rexx] [CPLCFG]
  296.  
  297.     CPLCFG  Force MM_StarTrack to re-compile its cfg
  298.  
  299.  
  300.   Normally it is used as documented at 3.4.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  5. Configuration
  307.  ================
  308.  
  309.   MM_StarTrack was originally  desinged for people having one #MAILAREA per net-
  310.   work they have. Therefore I can't guarantee that it will work 100% if you only
  311.   have a single #MAILAREA. I've done my best... Before v0.80, it didn't complain
  312.   if you had  only one #MAILAREA  but some functions like  remapping didn't work
  313.   correct.
  314.  
  315.  
  316.   Since 0.80 both methods are possible:
  317.  
  318.    1. You have one #MAILAREA per network (+ #BADAREA).
  319.    2. You have only one #MAILAREA for all networks you have (+ #BADAREA)
  320.  
  321.   In any other case, it will refuse to work!
  322.  
  323.  
  324.   MM_StarTrack has an advanced  config-reading-mechanism,  which implements your
  325.   config directly to the  script itself. This means once the config is compiled,
  326.   it will need less than one second (A3000 50/50MHz) to read its config!
  327.  
  328.   Only if you change the  config, it will need a while until all checks are done
  329.   and the config is compiled.
  330.  
  331.   Please take a close look  in the example config.  To check if it is configured
  332.   correct just start it.
  333.  
  334.  
  335.  
  336.   5.1 #DOMAIN - Domain related settings
  337.   -------------------------------------
  338.  
  339.     Here you have to set your different networks and related parameters.
  340.  
  341.     IMPORTANT: You need  one seperate #MAILAREA for every  domain!!! It an error
  342.                is  reported, please  check  your cfg  if the domains  are set up
  343.                correct.
  344.  
  345.  
  346.  
  347.     #DOMAIN     DOMAIN/A,ZONES,ADJUST/S
  348.  
  349.                   If valid zones  are not set, no  zone<>domain-checking will be
  350.                   done,  otherwise if  Adjust is NOT set, mails  where  the zone
  351.                   does not  match with  the domain  mails will  be treated  like
  352.                   UNKNOWN addresses.
  353.                   MM does a very good job in converting the different addressing
  354.                   -standards  (2-5D) to  the  right  address,  so this  function
  355.                   normally will only sort out wrong real 5D mails.
  356.  
  357.  
  358.  
  359.     Bounce      CROSSNET/S,UNKNDST/S,WRONGADDR/S
  360.  
  361.                   CrossNet    Bounce also CrossNet-netmails
  362.  
  363.                   UnknDst     Bounce if destination does not exist
  364.  
  365.                   WrongAddr   Bounce also mail with incorrect zone<->domain
  366.  
  367.  
  368.  
  369.     CheckEncoded MAXALLOWED/A/N,BOUNCE/S,MOVE/S,SPLIT/S
  370.  
  371.                   Enable check for encoded mail.
  372.  
  373.                   Bounce      Bounce mail back to the sender
  374.  
  375.                   Move        Move the mail  to #BADDIR. Otherwise  it will just
  376.                               be deleted.
  377.  
  378.                   Split       Check if  somebody tries  to send an  encoded file
  379.                               splitted over more mails.
  380.  
  381.  
  382.  
  383.      AllowEncoded(From|To) PATTERNS/M
  384.  
  385.                   Allow  sending  of encoded  mails,  if one  of the  pattern is
  386.                   matching. E.g. you can set "2:2490/1015.#?@#?" etc...
  387.  
  388.  
  389.  
  390.     CheckFATT   ADJUST/S,NOTIFY/S,PUTONHOLD/S,MOVEBAD/S,MOVEOWN/K/A
  391.  
  392.                   1. Enable advanced FileATTach-handling. MM itself stops FATT's
  393.                      for  third-parties,  but if MM  does so,  you have  to care
  394.                      about the stopped files. If you  use this, both sides  will
  395.                      be notified about what's going on and the  file will be put
  396.                      on hold if you want this.
  397.  
  398.                   2. MM_StarTrack  tries to  fix a  problem  caused  by multiple
  399.                      FATT's  with the  same  name. If  possible it  will  try to
  400.                      rename such a file back to the real name.
  401.  
  402.                   3. It is very common to  send more FATT's  in one msg by using
  403.                      multiple filenames in the  subject. Unfortunatelly  MM does
  404.                      not support this, so such a file can not be routed correct.
  405.                      MM_StarTrack will now check this and generate an additional
  406.                      msg  for  every  multiple  file, so  that  MM can  route it
  407.                      correct.
  408.  
  409.                   4. If a valid FATT could not be located, MM_StarTrack will in-
  410.                      form the sender about this problem.
  411.  
  412.                   Adjust     Enable  MM_StarTrack's  filename  adjustment.  This
  413.                              means  if  you  receive   files  named   like  e.g.
  414.                              Test.lha,1  it  tries  to  rename  such  a  file to
  415.                              Test.lha and the *,xx files will  be  deleted.  The
  416.                              only disadvantage of this methode is, that the file
  417.                              will  not be  deleted  when it was  sended  because
  418.                              there could be more msgs belonging to that file.
  419.  
  420.                   Notify     Notify source & destination about the stopped FATT.
  421.  
  422.                   PutOnHold  Put  the  file on  hold  for the  destination. This
  423.                              includes "Notify", so don't set them both.
  424.  
  425.                   MoveBad    Move the FATT-file to MM's #BADDIR.
  426.  
  427.                   You can set  PutOnHold *OR* MoveBad. If you  don't set  one of
  428.                   these two keywords, the file will simply be deleted.
  429.  
  430.                   MoveOwn    If  this  is enabled,  MM_StarTrack  will  move all
  431.                    {dir}     files for you to the  specified  directory, so that
  432.                              you can  use your #MAILAREA-(alt-)path as spool-dir
  433.                              for routed files.
  434.                              If MM_StarTrack has  moved a FATT to your Move-Own-
  435.                              dir, this will be  indicated  by a trailing  "!" in
  436.                              the subject-field of the msg.
  437.  
  438.  
  439.  
  440.     CheckLoop     When this keyword  is present,  StarTrack will perform a loop-
  441.                   check on the netmails.
  442.                   It will be checked if a system is listed more than once in the
  443.                   Via's. Multiple via's e.g. added by other trackers will not be
  444.                   detected as a loop of course :-)
  445.                   If a loop-mail was detected,  the sender & the  looping-system
  446.                   will be informed of the error. The  mail from StarTrack to the
  447.                   destination-system will  always  be a  CRASH-mail  to  prevent
  448.                   further problems.
  449.  
  450.  
  451.  
  452.     Delete      EMPTY/S,GOOD/S,OWN/S
  453.  
  454.                   Empty      Delete empty messages, e.g. from DOS-tickers
  455.  
  456.                   Good       Delete correct-routed msgs after exporting
  457.  
  458.                   Own        Delete msgs writen by StarTrack after exporting
  459.  
  460.  
  461.  
  462.     Export      When this  keyword is  given,  the area  will  automatically  be
  463.                 exported after  all msgs were  processed. If you use  tools like
  464.                 MM_AreaManager  by Frank Schnittger, you must  NOT use this key-
  465.                 word because MM_AreaManager also  searches for  intransit mails.
  466.                 In that case the mail-areas  will be exported  by these scripts.
  467.                 Or even better use MM_ExportPlus to export the queued areas.
  468.  
  469.  
  470.  
  471.     FromAddr    5D_ADDR/A
  472.  
  473.                   Use this  address  for msgs  created  by MM. If you  have  one
  474.                   #MAILAREA per  network, you  may  set it if you  want to use a
  475.                   different address than the area-base-address. If you only have
  476.                   a single #MAILAREA for all networks you have, you MUST set it!
  477.  
  478.  
  479.     LogFile     LOGFILE/A
  480.  
  481.                   MM_StarTrack will write a little  log for every netmail routed
  482.                   through your  system. If  this parameter is  not given, no log
  483.                   be written.
  484.                   If you place a %d somewhere  in the name, it will  be replaced
  485.                   with the  current  date (YY-MM-DD), so  that  you  are able to
  486.                   create the logs per day.
  487.  
  488.  
  489.  
  490.     LogModes    ALL/S,BAD/S,FLAGS/S,SUBJECT/S,ROUTING/S,VIAADDR/S,VIAALL/S
  491.  
  492.                   All|Bad     Log ALL routed/processed msgs or only BAD mails
  493.  
  494.                   Flags       Log also the flags of the msg
  495.  
  496.                   Routing     Log routing-info  if possible. Currently  you will
  497.                               only see where the  mail came form. Where  it goes
  498.                               to is  currently not  supported by MM, but  I hope
  499.                               Pino will add that soon as promissed ;-)
  500.  
  501.                   Size        Log also the size of the msg
  502.  
  503.                   Subject     Log also the subject of the msg
  504.  
  505.                   ViaAddr|    Log the  addresses of  the via-lines  or even  the
  506.                   ViaAll      complete  Via's to  keep track  of the way the msg
  507.                               goes.
  508.  
  509.  
  510.     ReturnReceipt SYSTEM/S,POINTS/S
  511.  
  512.                   System      Return-Receipt-Requests only if it is directly for
  513.                               this system.
  514.  
  515.                   Points      RRR also to mails for your points. This is usefull
  516.                               because the  most  (Amiga-)point-programs  do  not
  517.                               support the  sending  of  replies  to  RRR-flagged
  518.                               mails...
  519.  
  520.  
  521.  
  522.     Example:
  523.     --------
  524.  
  525.      #DOMAIN           AmigaNet    39,40,41   Adjust
  526.      Bounce            UnknDst WrongAddr ; CrossNet
  527.      CheckEncoded      5120 Bounce Move Split
  528.       AllowEncodedFrom 39:171/101.#?@AmigaNet
  529.       AllowEncodedTo   39:101/303.#?@AmigaNet
  530.      CheckFATT         Adjust Notify PutOnHold Out:FileAttachs/
  531.      CheckLoop
  532.      Delete            Good Empty Own
  533.      ;Export
  534.      LogFile           Temp_Logs:NM_AmigaNet.log
  535.      LogModes          All Flags Routing Size Subject ViaAddr
  536.      ReturnReceipt     System Points
  537.  
  538.  
  539.  
  540.   5.2 #BADAREA - Bad netmail area
  541.   -------------------------------
  542.  
  543.    This is  the area where bad  netmails will be  moved or copied too.  You MUST
  544.    install such an area, otherwise MM_StarTrack is unable to work!
  545.  
  546.     #BADAREA      AREATAG/A
  547.  
  548.    If you are  using MM_ImportPlus with a different  #BADDIR than  MM's #BADDIR,
  549.    you have to set  the altpath to the used  #BADDIR, otherwise in *very* *rare*
  550.    situations, a received FATT can not be detected.
  551.  
  552.  
  553.    Example:
  554.    --------
  555.  
  556.     #BADAREA     BAD_NETMAILS
  557.  
  558.  
  559.  
  560.   5.3 #LANGUAGE - Localization
  561.   ----------------------------
  562.  
  563.    This part controlles the localization of MM_StarTrack.
  564.  
  565.     #LANGUAGE     LANG_EXT/A,ADDR_PATTERN/A
  566.  
  567.    The  language-extension will indicate  which  text  will be  used  for  which
  568.    address. No extension  will be used if no  special language  is set. Normally
  569.    the  text-files  in  the Texts-directory  without  extensions  should  be  in
  570.    English.
  571.  
  572.    The best would be to name  the extenion like used in the echo-areas e.g. GER,
  573.    ITA, DEN, ESP, etc...
  574.  
  575.    You can use MM-address-patterns so set up your languages.
  576.  
  577.    It would be very nice to translate new languages for me! If you do so, please
  578.    send them to me, so that the  language can be included in a future release of
  579.    MM_StarTrack.
  580.  
  581.    If you have other ideas for the text, please also send them to me.
  582.  
  583.  
  584.    The texts have to be named like MM:Config/MM_StarTrack/Texts.<ext>/<file>
  585.  
  586.  
  587.    Example:
  588.    --------
  589.  
  590.     #LANGUAGE   GER   2:24#?/#?.#?@#?
  591.  
  592.  
  593.  
  594.   5.4 #(NO)STATISTICS - Statistics managment
  595.   -------------------
  596.  
  597.    This controlls the statistics of MM_StarTrack. This was necessary, because on
  598.    some systems, MM_StarTrack sometimes was hanging somewhere in "Writing stati-
  599.    stics...". It seems that this is  an ARexx-bug itself because there definitly
  600.    is no error  in MM_StarTrack! It was not  possible to locate  or prevent this
  601.    error...
  602.  
  603.    If it is working on your system without any problems, keep it on. It does not
  604.    make any big difference, only the writing of the statistics-file is disabled.
  605.    It will not effect the time needed for msg-processing.
  606.  
  607.    If you have any idea, why this could happen, please netmail me!!!
  608.  
  609.  
  610.  
  611.   5.5 #EXCLUDE[ADDR|NAME|SUBJ] - Excluding msgs form being processed
  612.   ------------------------------------------------------------------
  613.  
  614.    Here you can set which  addresses,  senders, subjects are excluded from being
  615.    processed.
  616.  
  617.  
  618.    5.5.1 Field-specific
  619.  
  620.     #EXCLUDE(ADDR|NAME|SUBJ) PATTERN/A
  621.  
  622.     The pattern  is a valid address, name or subject-pattern which will indicate
  623.     the msg as excluded.
  624.  
  625.  
  626.     Examples:
  627.     ---------
  628.  
  629.      #EXCLUDENAME  #?TRACK#?
  630.      #EXCLUDEADDR  2:2490/1015.1@#?
  631.      #EXCLUDESUBJ  #?TEST#?
  632.  
  633.  
  634.    5.5.2 Enhanced pattern-matching
  635.  
  636.     Here you can set a pattern  over nearly all fields  of the msg. Only  if all
  637.     fields do match, the msg will be excluded.
  638.  
  639.     #EXCLUDE  FROM_PATTERN/A,FROMADDR_PATTERN/A,TO_PATTERN/A,TOADDR_PATTERN/A,
  640.               SUBJ_PATTERN/A
  641.  
  642.  
  643.     Example:
  644.     --------
  645.  
  646.      #EXCLUDE  Robert#?  #?:#?/#?.1@#?  Test1#?  #?:#?/#?.#?@#?  #?TEST#?
  647.  
  648.  
  649.  
  650.   5.6 #EXECUTE[ADDR|NAME|SUBJ] - Execute a command for received netmail
  651.   ---------------------------------------------------------------------
  652.  
  653.    With this  statement, you can  execute external  commands for  every received
  654.    netmail. Please be carefull if you  use it! If you don't know what you do, it
  655.    might be possible that you'll delete all netmails or all will be excluded, so
  656.    please read this *VERY* *CAREFULL* so that you'll know how to use it!
  657.  
  658.    I am *not* responsible for any problems caused by using this function!!!
  659.  
  660.    I've implemented this function to have a better support for external tools
  661.    like an areafix, a ghostwriter or something like that.
  662.  
  663.  
  664.    5.6.1 Field-specific
  665.  
  666.     #EXECUTE(ADDR|NAME|SUBJ) PATTERN/A,COMMAND/A
  667.  
  668.     The pattern is a valid  address, name or subject-pattern which will indicate
  669.     that a command has to be executed for this mail.
  670.  
  671.  
  672.     Examples:
  673.     ---------
  674.  
  675.      #EXECUTENAME #?AREAFIX#? echo "%a %n %S"
  676.      #EXECUTENAME #Rob#?Hof#? rx MM:Rexx/MM_BackupMsg DELAYED_ANSWERS %a %n
  677.  
  678.  
  679.    5.6.2 Enhanced pattern-matching
  680.  
  681.     Here you can set a pattern  over nearly all fields  of the msg. Only  if all
  682.     fields do match, the defined command will be executed.
  683.  
  684.      #EXECUTE  FROM_PATTERN/A,FROMADDR_PATTERN/A,TO_PATTERN/A,TOADDR_PATTERN/A,
  685.                SUBJ_PATTERN/A
  686.      Arguments COMMAND/A
  687.  
  688.  
  689.     Example:
  690.     --------
  691.  
  692.      #EXECUTE   Robert#? #?:#?/#?.1@#? Test2#? #?:#?/#?.#?@#? #?TEST#?
  693.      Arguments  echo "Test"
  694.  
  695.  
  696.    5.6.3 Embedded %-commands
  697.  
  698.     Of course must have the  possibility to get  all needed infos to a msg. This
  699.     is possible while using %-commands withing the command-statement.
  700.  
  701.     You can use the following shortcuts:
  702.  
  703.      %a       = areaname
  704.      %n       = msg-number
  705.  
  706.      %cd      = creation date
  707.      %ct      = creation time
  708.      %fa      = from-address
  709.      %ff      = from-firstname
  710.      %fs      = from-surname
  711.      %f       = full fromname
  712.      %F       = msg-flags
  713.      %id      = import date
  714.      %it      = import time
  715.      %sa      = system-address
  716.      %sf      = sysop-firstname
  717.      %ss      = sysop-surname
  718.      %s       = full sysopname
  719.      %S       = subject
  720.      %ta      = to-address
  721.      %tf      = to-firstname
  722.      %ts      = to-surname
  723.      %t       = full to-name
  724.      %T<file> = save the complete msgtext (incl. kludges) to the given file
  725.                 Note: *Always* set %T as *LAST* argument!!!
  726.  
  727.  
  728.     Examples:
  729.     --------
  730.  
  731.      rx TestMsg %a %n %fa %Tt:Msg.text
  732.      echo "%a %n %fa" %Tt:Msg.text
  733.  
  734.  
  735.    5.6.4 Msg-control
  736.  
  737.     With the return-code of your command, you can control what will be done with
  738.     the msg. Please be careful with that! Be sure that your prg, script or batch
  739.     -file does exit with a clear defined RC, noramlly 0.
  740.  
  741.     For MM_StarTrack, you can use the following codes:
  742.  
  743.      RC = 0  all ok, continue with further checks
  744.      RC = 1  treat the msg as #KILL-mail
  745.      RC = 2  treat the msg as #TWIT-mail
  746.      RC > 2  the mail will be excluded
  747.  
  748.     E.g. an AreaFix which may take use of this function should return with 5, so
  749.     that the mail will be excluded.
  750.  
  751.  
  752.  
  753.   5.7 #FORWARD[ADDR|NAME|SUBJ] - Forward a received netmail
  754.   ---------------------------------------------------------
  755.  
  756.    With this  statement, you can forward certain msgs to a  certain person/echo.
  757.  
  758.  
  759.    5.7.1 Field-specific
  760.  
  761.     #FORWARD(ADDR|NAME|SUBJ) PATTERN/A,AREA/K/A,TO/K/A,TOADDR/K,SUBJ/K/A,
  762.                              FLAGS/K,DELORIGMSG
  763.  
  764.     PATTERN     A valid  address,  name or  subject-pattern  which will indicate
  765.                 that the msg has to be forwarded.
  766.  
  767.     AREA        The area  to forward  the  msg  to.  Use "%ma"  for the  current
  768.                 mailarea.
  769.  
  770.     TO          Name of the receiver.
  771.  
  772.     TOADDR      Address of the receiver.
  773.  
  774.     SUBJECT     Subject to use. Shortcuts are possible (see 5.7.3).
  775.  
  776.     FLAGS       Flags for the msg. See MM.doc/MM_WriteMsg for details.
  777.  
  778.     DELORIGMSG  Delete the original msg from your mailarea. But be carefull with
  779.                 this!!!
  780.  
  781.  
  782.  
  783.     Examples:
  784.     ---------
  785.  
  786.      #FORWARD   "Joe User" AREA TEST TO All SUBJ "Test FW" FLAGS KILL DELORIGMSG
  787.  
  788.  
  789.  
  790.    5.7.2 Enhanced pattern-matching
  791.  
  792.     Here you can set  patterns  over nearly all fields  of the msg. Only  if all
  793.     fields do match, the defined command will be executed.
  794.  
  795.      #FORWARD   FROM_PATTERN/A,FROMADDR_PATTERN/A,TO_PATTERN/A,TOADDR_PATTERN/A,
  796.                 SUBJ_PATTERN/A
  797.      Arguments  AREA/K/A,TO/K/A,TOADDR/K,SUBJ/K/A,FLAGS/K/M,DELORIGMSG/S
  798.  
  799.     Please see 5.7.1 for the description of the "Arguments".
  800.  
  801.  
  802.     Example:
  803.     --------
  804.  
  805.      #FORWARD   GEcho 2:2490/1960.0@FidoNet  #?  2:2490/1015.0@FidoNet Area#?
  806.      Arguments  AREA !AmiSTEP_DOWNLINKS TO Alle SUBJ "Areafix-Antwort von %fa" FLAGS KILL DELORIGMSG
  807.  
  808.  
  809.    5.7.3 Embedded %-commands
  810.  
  811.     Of course must have the  possibility to get  all needed infos to a msg. This
  812.     is possible while using %-commands withing the command-statement.
  813.  
  814.     You can use the following shortcuts:
  815.  
  816.      %cd      = creation date
  817.      %ct      = creation time
  818.      %fa      = from-address
  819.      %ff      = from-firstname
  820.      %fs      = from-surname
  821.      %f       = full fromname
  822.      %F       = msg-flags
  823.      %id      = import date
  824.      %it      = import time
  825.      %sa      = system-address
  826.      %sf      = sysop-firstname
  827.      %ss      = sysop-surname
  828.      %s       = full sysopname
  829.      %S       = subject
  830.      %ta      = to-address
  831.      %tf      = to-firstname
  832.      %ts      = to-surname
  833.      %t       = full to-name
  834.  
  835.  
  836.   5.8 #KILL[ADDR|NAME|SUBJ] - Killing msgs for your system  *** BE CAREFULL ***
  837.   --------------------------------------------------------
  838.  
  839.    Here you can  set a kind of  filter for msgs to your  system. Please be  very
  840.    carefull because if the pattern matches the mail will be deleted!!!
  841.  
  842.  
  843.    5.8.1 Field-specific
  844.  
  845.     #KILL(ADDR|NAME|SUBJ) PATTERN/A,BOUNCE/S,MOVE/S
  846.  
  847.     The pattern is a valid  address, name or subject-pattern which will indicate
  848.     the msg as to kill.
  849.  
  850.     Bounce   The msg  will be bounced like an undeliverable  mail insted of just
  851.              being deleted.
  852.  
  853.     Move     the msg to your bad-netmail-area.
  854.  
  855.  
  856.     Examples:
  857.     ---------
  858.  
  859.      #KILLNAME  #?TICK#?
  860.      #KILLADDR  1:234/567.#?@#?
  861.      #KILLSUBJ  #?TEST#?
  862.  
  863.  
  864.    5.8.2 Enhanced pattern-matching
  865.  
  866.     Here you can set a pattern  over nearly all fields  of the msg. Only  if all
  867.     fields do match, the msg will be killed.
  868.  
  869.      #KILL     FROM_PATTERN/A,FROMADDR_PATTERN/A,TO_PATTERN/A,TOADDR_PATTERN/A,
  870.                SUBJ_PATTERN/A
  871.      Arguments BOUNCE/S,MOVE/S
  872.  
  873.  
  874.     Example:
  875.     --------
  876.  
  877.      #KILL     Robert#?  #?:#?/#?.1@#?  Test2#?  #?:#?/#?.#?@#?  #?TEST#?
  878.      Arguments Move
  879.  
  880.  
  881.  
  882.   5.9. #TWIT[ADDR|NAME|SUBJ] - Twitting msgs
  883.   ------------------------------------------
  884.  
  885.    Filter  msgs  from routing.  If  twit  is true,  the msg  will be  deleted or
  886.    bounced, depending or your settings.
  887.  
  888.  
  889.    5.9.1 Field-specific
  890.  
  891.     #TWIT(ADDR|NAME|SUBJ) PATTERN/A,BOUNCE/S,MOVE/S
  892.  
  893.     The pattern is  a valid address, name or subject-pattern which will indicate
  894.     the msg as twitmail.
  895.  
  896.     Bounce   The msg will be bounced like an undeliverable mail.
  897.  
  898.     Move     The msg will be moved to the #BADAREA instead of just being deleted
  899.  
  900.  
  901.     Note: The Twitfilter is only active for msgs NOT to your system!
  902.  
  903.  
  904.     Examples:
  905.     ---------
  906.  
  907.      #TWITNAME   #?ALLFIX#?         Bounce
  908.      #TWITADDR   2:2490/1018.#?@#?
  909.      #TWITSUBJ   #?TEST#?
  910.  
  911.      In this  case, e.g.  Areafix-msgs  for  other  systems will  not be  routed
  912.      through my system.
  913.  
  914.  
  915.    5.9.2 Enhanced pattern-matching
  916.  
  917.     Here you can set a pattern  over nearly all fields  of the msg. Only  if all
  918.     fields do match, the msg will be twitted.
  919.  
  920.     #TWIT     FROM_PATTERN/A,FROMADDR_PATTERN/A,TO_PATTERN/A,TOADDR_PATTERN/A,
  921.               SUBJ_PATTERN/A
  922.     Arguments BOUNCE/S,MOVE/S
  923.  
  924.  
  925.     Example:
  926.     --------
  927.  
  928.      #TWIT     Robert#?  #?:#?/#?.1@#?  Test2#?  #?:#?/#?.#?@#?  #?TEST#?
  929.      Arguments Bounce
  930.  
  931.  
  932.  
  933.   5.10 #REMAP(FROM|TO) - Remapping msgs and/or users
  934.   --------------------------------------------------
  935.  
  936.    Here you can remap msgs. But be careful! This is a very powerful function, so
  937.    read this part *VERY* *CAREFULLY*!!!
  938.  
  939.  
  940.    IMPORTANT NOTE: If you upgrade from a MM_StarTrack-version <0.95, you have to
  941.                    "rx MM_ST_ConvertCfg" because there is a *MAJOR* change up to
  942.                    version >=0.95!!!
  943.  
  944.  
  945.    #REMAP(FROM|TO)
  946.  
  947.    Address  OLD,NEW   OLD  The old from/to-address
  948.                       NEW  The new from/to-address
  949.  
  950.    Name     OLD,NEW   OLD  The old from/to-name
  951.                       NEW  The new from/to-name
  952.  
  953.    AddInfo            Add the file Text.Remap{Src|Dst} at the top of the msg.
  954.  
  955.    Reply              ONLY valid for #REMAPTO!
  956.  
  957.  
  958.    You need not use  all these fields. In general, this function  can be divided
  959.    into five parts:
  960.  
  961.     1. Remap only the name, not depending on the  address. In this  case, do not
  962.        use an 'Address'-statement.
  963.  
  964.     2. Remap only  the address, not depending  on the name. In this case, do not
  965.        use a 'Name'-statement.
  966.  
  967.     3. Remap the name depending on the address. In this case, 'Addr OLD' & 'Name
  968.        OLD,NEW' must be set.
  969.  
  970.     4. Remap  a name to  multiple new  addresses, depending on  the domain. This
  971.        means, check the name  and if it matches, use that new address, where the
  972.        domains are matching. In  this case, you must  set at least  'Name OLD' &
  973.        'Address NEW', where NEW can be '"<addr> [addr] [...]"'. You must not use
  974.        'Address OLD' in this case but you  can use 'Name NEW' to remap the name,
  975.        too.
  976.  
  977.     5. Remap address & name  to a new address  & name. In  this case  all fields
  978.        have to be used.
  979.  
  980.  
  981.    You can use wildcards nearly  *EVERYWHERE*! E.g. you  can remap all msgs from
  982.    "Robert Ho(f|ff)man(n|nn)" to "Robert Hofmann" etc...
  983.  
  984.    You have to use  5D-addresses only. The  new address may  also contain simple
  985.    wildcards. To make  sure that you use working wildcards, please check  it out
  986.    with  MM_ST_CheckWildcard.rexx  which  you  can  find  in the  rexx-drawer of
  987.    MM_Startrack  (see also 5.10.1). This is  only neccessary if  the new address
  988.    also contains a wildcard.
  989.  
  990.    The new dest.addr. has to exist or  listed in your #NODEs,  otherwise it will
  991.    be bounced.
  992.  
  993.  
  994.    Examples:
  995.    ---------
  996.  
  997.     #REMAPFROM
  998.     Name       OLD "Joe User"                 NEW "Robert Hofmann"
  999.     AddInfo
  1000.  
  1001.     #REMAPFROM
  1002.     Address    OLD 2:2490/1015.1@FidoNet      NEW 2:2490/1015.0@FidoNet
  1003.  
  1004.     #REMAPTO
  1005.     Name       OLD "(Pino|Guiseppe) Aliberti" NEW "Pino Aliberti"
  1006.     Address    NEW "2:335/602.2@FidoNet 39:102/10.0@AmigaNet"
  1007.     Reply
  1008.  
  1009.     #REMAPTO
  1010.     Name       OLD "Robert Ho(f|ff)ma(n|nn)"  NEW "Robert Hofmann"
  1011.     Address    NEW "2:2490/1015.1@FidoNet 39:171/101.1@AmigaNet"
  1012.  
  1013.     #REMAPTO
  1014.     Address    OLD 2:2490/11.0@FidoNet
  1015.     Name       OLD "GATE"                     NEW "UUCP"
  1016.  
  1017.     #REMAPTO
  1018.     Name       OLD "Bernd Ernesti"
  1019.     Address    NEW 39:173/40.0@AmigaNet
  1020.     AddInfo
  1021.  
  1022.  
  1023.   5.10.1  Using CheckWildcard
  1024.   - - - - - - - - - - - - - -
  1025.  
  1026.    CheckWildcard  is  a  small  script  to  test the  wildcard-remap-function of
  1027.    MM_StarTrack.
  1028.  
  1029.    The usage is very simple:
  1030.  
  1031.     [RX] MM_ST_CheckWildcard[.rexx] ADDRESS/A,FROM_PATTERN/A,TO_PATTERN/A
  1032.  
  1033.      ADDRESS         the address to be remapped
  1034.      FROM_PATTERN    a pattern matching with the address
  1035.      TO_PATTERN      a patten for the new address
  1036.  
  1037.  
  1038.    If you don't understand what I mean, just try it with
  1039.  
  1040.     rx MM_ST_CheckWildcard 39:171/112.7@AmigaNet 39:171/11#?.#?@#? 39:171/61#?.#?@#?
  1041.  
  1042.  
  1043.  
  1044.   5.11 Nodelists
  1045.   --------------
  1046.  
  1047.    5.11.1 #COMPILENL
  1048.  
  1049.     The "traplist"-command, distributed with traplist.
  1050.  
  1051.     #COMPILENL COMMAND/A
  1052.  
  1053.     If MM_StarTrack's  nodelist-check does  fail five times, it  will re-compile
  1054.     the nodelists if you set this. See 9. for more infos.
  1055.  
  1056.  
  1057.     Example:
  1058.     --------
  1059.  
  1060.      #COMPILENL traplist mail:traplist.cfg
  1061.  
  1062.  
  1063.    5.11.2 #SHOWNL
  1064.  
  1065.     The "shownl"-command, distributed with traplist.
  1066.  
  1067.     #SHOWNL COMMAND/A
  1068.  
  1069.     This is necessary for the %nl command you can use inside the textfiles.
  1070.  
  1071.  
  1072.     Example:
  1073.     --------
  1074.  
  1075.      #SHOWNL TrapDoor:ShowNL
  1076.  
  1077.  
  1078.  
  1079.  5.12 #MAILROBOT PATTERN/A
  1080.  -------------------------
  1081.  
  1082.   Here you have to tell  MM_StarTrack what names are  used by any  kind of mail-
  1083.   robot you are using. E.g. Areafixes or something like that.
  1084.  
  1085.  
  1086.    Examples:
  1087.    ---------
  1088.  
  1089.     #MAILROBOT   #?(AreaFix|AreaMgr|AreaManager|MM_AreaManager)#?
  1090.     #MAILROBOT   #?(FileFix|Raid|FileScan|AllFix|FileManager|FileMgr)#?
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  6. Textfiles
  1097.  ============
  1098.  
  1099.   The text-files are the files in  MM:Config/MM_StarTrack/Texts[.<LANG>]/#?. You
  1100.   can adjust them as you  like, but you should not  change their sense of course
  1101.   ;-)
  1102.  
  1103.   These files can be localized as described at 5.3.
  1104.  
  1105.  
  1106.   In all textfiles, you can use the following embedded %-commands:
  1107.  
  1108.     %cd   = creation date
  1109.     %ct   = creation time
  1110.     %fa   = from-address
  1111.     %ff   = from-firstname
  1112.     %fs   = from-surname
  1113.     %f    = full fromname
  1114.     %F    = msg-flags
  1115.     %id   = import date
  1116.     %it   = import time
  1117.     %nl   = used nodelists
  1118.     %sa   = system-address
  1119.     %sf   = sysop-firstname
  1120.     %ss   = sysop-surname
  1121.     %s    = full sysopname
  1122.     %S    = subject
  1123.     %ta   = to-address
  1124.     %tf   = to-firstname
  1125.     %ts   = to-surname
  1126.     %t    = full to-name
  1127.     %T    = complete msgtext
  1128.     %T<#> = <#> of lines to be forwarded.
  1129.  
  1130.  
  1131.   6.1 Bounced
  1132.   -----------
  1133.  
  1134.    This text will be send  to the source of the msg when  MM_StarTrack detects a
  1135.    unknown destination-address.
  1136.  
  1137.  
  1138.  
  1139.   6.2 CrossNet_ToDst
  1140.   ------------------
  1141.  
  1142.    This text will be send to the destination of a cross-net-netmail.
  1143.  
  1144.  
  1145.  
  1146.   6.3 CrossNet_ToSrc
  1147.   ------------------
  1148.  
  1149.    This text will be send to the source of a loop-mail.
  1150.  
  1151.  
  1152.  
  1153.   6.4 Encoded
  1154.   -----------
  1155.  
  1156.    This text will be used for bouncing encoded mails.
  1157.  
  1158.  
  1159.  
  1160.   6.5 FATT-Hold_ToDst
  1161.   -------------------
  1162.  
  1163.    If you have  set  "CheckFATT PutOnHold",  this  text  will  be  send  to  the
  1164.    destination.
  1165.  
  1166.  
  1167.  
  1168.   6.6 FATT-Hold_ToSrc
  1169.   -------------------
  1170.  
  1171.    If you have set  "CheckFATT PutOnHold", this text will be send  to the sender
  1172.    of the mail.
  1173.  
  1174.  
  1175.  
  1176.   6.7 FATT-Killed_ToDst
  1177.   ---------------------
  1178.  
  1179.    If you have NOT set "CheckFATT PutOnHold", this  text  will be  send  to  the
  1180.    destination.
  1181.  
  1182.  
  1183.  
  1184.   6.8 FATT-Killed_ToSrc
  1185.   ---------------------
  1186.  
  1187.    If you have NOT set "CheckFATT PutOnHold", this  text  will be  send  to  the
  1188.    destination.
  1189.  
  1190.  
  1191.  
  1192.   6.9 Loop_ToDst
  1193.   --------------
  1194.  
  1195.    This text will be sent CRASH to the msg-destination.
  1196.  
  1197.  
  1198.  
  1199.   6.10 Loop_ToLink
  1200.   ----------------
  1201.  
  1202.    This text will be send to the up/downlink of a detected loopmail.
  1203.  
  1204.  
  1205.  
  1206.   6.11 Loop_ToSrc  (Loopmail To Source)
  1207.   ---------------
  1208.  
  1209.    This text will be send to the source of a cross-net-netmail.
  1210.  
  1211.  
  1212.  
  1213.   6.12 Misc  (Misc texts)
  1214.   ---------
  1215.  
  1216.    Miscellenous texts...
  1217.  
  1218.    #SUBJ_BOUNCE_CROSSNET     <Subject for bounced crossnet netmails>
  1219.  
  1220.    #SUBJ_BOUNCE_ENCODED      <Subject for bounced encoded  netmails>
  1221.  
  1222.    #SUBJ_BOUNCE_KILL         <Subject for bounced killed   netmails>
  1223.  
  1224.    #SUBJ_BOUNCE_SPLITENCODED <Subject for bounced splitted encoded  netmails>
  1225.  
  1226.    #SUBJ_BOUNCE_TWIT         <Subject for bounced twitted  netmails>
  1227.  
  1228.    #SUBJ_BOUNCE_UNKNDST      <Subject for bounced unknown destination netmails>
  1229.  
  1230.    #SUBJ_CROSSNET_TODST      <Subject for crossnet netmails, used for writing to
  1231.                               the destination system>
  1232.  
  1233.    #SUBJ_CROSSNET_TOSRC      <Subject for crossnet netmails, used for writing to
  1234.                               the source system>
  1235.  
  1236.    #SUBJ_FATT_TOSRC          <Subject for FileAttaches, used  for writing to the
  1237.                               source-system>
  1238.  
  1239.    #SUBJ_LOOP_TODST          <Subject  for Loop-mails,  used  for writing to the
  1240.                               destination system>
  1241.  
  1242.    #SUBJ_LOOP_TOLINK         <Subject  for Loop-mails,  used  for writing to the
  1243.                               link which causes the loop>
  1244.  
  1245.    #SUBJ_LOOP_TOSRC          <Subject  for Loop-mails,  used  for writing to the
  1246.                               source-system>
  1247.  
  1248.    #SUBJ_NOFATT              <subject for msgs where the FATT-flag  was set, but
  1249.                               no file could be found (%fatt = file; %sa = system
  1250.                               address>
  1251.  
  1252.    #SUBJ_REMAP_REPLY         <Subject for remapping-reply's>
  1253.  
  1254.    #SUBJ_RRR                 <Subject for returning receipt-requests>
  1255.  
  1256.    #SUBJ_UNKNSRC             <Subject for forwarding Unknown-Source-addresses>
  1257.  
  1258.  
  1259.  
  1260.   6.13 Remap_Dst
  1261.   --------------
  1262.  
  1263.    If configured, this text will be added at the top of a msg when a destination
  1264.    -address was changed.
  1265.  
  1266.    In addition to the normal embedded %-commands, here you can use
  1267.  
  1268.     %n = new address
  1269.     %o = old address
  1270.  
  1271.    %T is NOT available!
  1272.  
  1273.  
  1274.  
  1275.   6.14 Remap_Reply
  1276.   ---------------
  1277.  
  1278.    If configured, this text will be send  to the source that the msg he has sent
  1279.    to somebody was remapped.
  1280.  
  1281.    In addition to the normal embedded %-commands, here you can use
  1282.  
  1283.      %n = new address
  1284.      %o = old address
  1285.  
  1286.    %T is NOT available!
  1287.  
  1288.  
  1289.  
  1290.   6.15 Remap_Src  (Remap Source)
  1291.   --------------
  1292.  
  1293.    If  configured, this  text will be added  at the top of a  msg when a source-
  1294.    address was changed.
  1295.  
  1296.    In addition to the normal embedded %-commands, here you can use
  1297.  
  1298.      %n = new address
  1299.      %o = old address
  1300.  
  1301.    %T is NOT available!
  1302.  
  1303.  
  1304.  
  1305.   6.16 ReturnReceiptRequest  (Return Receipt Request)
  1306.   -------------------------
  1307.  
  1308.    This  text will be sent as  receipt if the RRR-flag was  set for an  incoming
  1309.    msg.
  1310.  
  1311.  
  1312.  
  1313.   6.17 Split_Encoded
  1314.   ------------------
  1315.  
  1316.    This text will be used for bouncing splitted encoded mails.
  1317.  
  1318.  
  1319.  
  1320.   6.18 Twit
  1321.   ---------
  1322.  
  1323.    This text  will be send to the  source of the msg when MM_StarTrack detects a
  1324.    twit-mail.
  1325.  
  1326.  
  1327.  
  1328.   6.19 Unknown_Source
  1329.   -------------------
  1330.  
  1331.    Finally when an unknown sourc-address was detected, this text will be used.
  1332.  
  1333.  
  1334.  
  1335.   6.20 FATT-Multiple
  1336.   ------------------
  1337.  
  1338.    This text will be used for a msg generated  by MM_StarTrack to route multiple
  1339.    FATT's.
  1340.  
  1341.  
  1342.  
  1343.   6.21 FATT-NotFound
  1344.   ------------------
  1345.  
  1346.    This text will be sent to the sender if  a file for a valid FATT could not be
  1347.    found.
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  7. Statistics
  1354.  =============
  1355.  
  1356.   MM_StarTrack also offers  you some statistics about  the processed  mails. You
  1357.   can find them in the file MM:Config/MM_StarTrack/MM_StarTrack.Statistics.
  1358.  
  1359.   Please  do not  touch the filenote or  delete the file,  because otherwise all
  1360.   your statistics will be lost.
  1361.  
  1362.   The statistic-informations are stored  in the filenote of the statistics-file.
  1363.   Please see also 5.4.
  1364.  
  1365.  
  1366.   Example:
  1367.   --------
  1368.  
  1369.    Netmail-Statistics of MM_StarTrack v0.80:
  1370.    =========================================
  1371.      (since 01-Jul-1995)
  1372.  
  1373.  
  1374.      CrossNet mails ......:     4
  1375.      Empty mails .........:    48
  1376.      Encoded mails .......:     4
  1377.      Excluded mails ......:   695
  1378.      Fileattaches ........:     0
  1379.      Killed mails ........:     3
  1380.      Loop mails ..........:     0
  1381.      Twitted mails .......:    50
  1382.      Unknown destinations :    59
  1383.      Unknown senders .....:    51
  1384.      ------------------------------
  1385.      Mails with errors etc:   914
  1386.  
  1387.  
  1388.      Remapped source-addr :   645
  1389.      Remapped dest.-addr .:   552
  1390.      Returned receipt's ..:    24
  1391.      Nothing to do .......:  1410
  1392.      ------------------------------
  1393.      Mails without errors :  2631
  1394.  
  1395.  
  1396.      ==============================
  1397.      Total mails processed:  3365
  1398.      Total kbytes routed .: 11081
  1399.  
  1400.      Times program used ..:  1004
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  8. Message-handling
  1407.  ===================
  1408.  
  1409.   In  general  MM_StarTrack will  not  change  any mail  (except at  remapping &
  1410.   stopping  FATT's), but  forward any  corrupted  mail  (like  mails of  unknown
  1411.   senders, twitmails etc.) to the source and/or destination.
  1412.  
  1413.   This is done to prevent further complications on other systems.
  1414.  
  1415.   In  addition to  that MM_StarTrack  offers  you the  ability to copy/move  bad
  1416.   netmails to a special directory, so that you can rescue them if possible.
  1417.  
  1418.  
  1419.   MM_StarTrack also supports the REPLYADDR & REPLYTO-kludges, what means that if
  1420.   it replies to  a mail containing such  kludges, it will  override  To & ToAddr
  1421.   with the ones found in the kludges, and add a "To: ..."-line at the top of the
  1422.   reply, e.g.
  1423.  
  1424.    @REPLYADDR joe_user@exaple.uucp.addr (Joe User)
  1425.    @REPLYTO 1:234/567.0 GATE example.uucp.addr.org
  1426.  
  1427.   will set the To-field of the msg to "GATE example.uucp.addr.org", the To-Addr-
  1428.   field to  "1:234/567.0@FidoNet"  and will insert a  To-line  at the top of the
  1429.   msgtext like "To: joe_user@exaple.uucp.addr (Joe User)".
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  9. Additional info's
  1436.  ====================
  1437.  
  1438.   When started MM_StarTrack will check if your first address configured in MM is
  1439.   accessable via the nodelist. If not it will wait 30 seconds, retry until it is
  1440.   there. If it is not found after the fifth try MM_StarTrack will try to compile
  1441.   the nodelist  (see 5.11). If this  does not solve  the problems, it will break
  1442.   with an  error.
  1443.  
  1444.   This was  done,  because if you  compile your  nodelist while  MM_StarTrack is
  1445.   working (what normally should never happen!!!), every address is unknown which
  1446.   causes unnecessary errors and confusion.
  1447.  
  1448.   Also due to some unknown  reasons, the "Nodelist  won't open" here  sometimes.
  1449.   Don't ask me  why. If this  happens, a compilation of  the nodelist (see  also
  1450.   5.11.1) does solve this problem.
  1451.  
  1452.  
  1453.   When MM_StarTrack has to  modify a msg, e.g. when  it has to insert  some text
  1454.   (#REMAP*: AddInfo), it will  insert a kludge called "@ORIGDATE <original date"
  1455.   to "keep" the original date of the msg. This was  done because while editing a
  1456.   msg, MM always sets the current  timestamp and does not keep the original one.
  1457.   I was not able to convince Pino to keep the original infos of a msg. 8^(
  1458.  
  1459.  
  1460.   Also MM_StarTrack inserts a "@ROBOTMAIL"-kludge  to all msgs written by it, to
  1461.   indicate that this was a mail done by a mailrobot.
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  10. Known Bugs
  1468.  ==============
  1469.  
  1470.   - None (I hope so :-)
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  11. Future
  1477.  =========
  1478.  
  1479.   Please  report me all bugs  and suggestions, so that  we can develop MM to the
  1480.   best FTN-software on the Amiga!
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  12. Acknowledgements
  1487.  ====================
  1488.  
  1489.   Pino Aliberti       For his EXCELLENT MailManager! For implementing nearly all
  1490.                       I wanted  (this was  much  work I  think and  delayed  the
  1491.                       release of MM  for some  month ;-)) For  our hard but fair
  1492.                       fights in MMBETA and at least for  the nice note  about me
  1493.                       in the docs 8^))))
  1494.  
  1495.  
  1496.   Bernardo Innocenti  For translating the Italian textfiles
  1497.  
  1498.  
  1499.   Andreas Netscher    For betatesting and some good suggestions
  1500.  
  1501.  
  1502.   Miguel Barnosi      For translating the Spanish textfiles
  1503.  
  1504.  
  1505.   Stig Poulsen        For betatesting & translating the Danish textfiles
  1506.  
  1507.  
  1508.   Eugene Stepanoff    For translating the Russian textfiles
  1509.  
  1510.  
  1511.   Tomasz Nidecki      For translating the Polish textfiles
  1512.  
  1513.  
  1514.   Chris Quonoey       For betatesting & very detailed bugreports!
  1515.  
  1516.  
  1517.   Helmut Steeg        For his excellent German translation of this doc!
  1518.  
  1519.  
  1520.   Erik Boersting      For betatesting & very detailed bugreports!
  1521.  
  1522.  
  1523.   Kent Hansen         For betatesting & detailed bugreports!
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.   _  o         Robert Hofmann         2:2490/1015@FidoNet   37:108/220@TrekNet
  1534.  |<)_/#                              39:171/101@AmigaNet   107:1805/230@TrekNet
  1535.  TT  <T  robert@next.amistep.osn.de  56:63/201@XNet        213:314/9127@XCessNet
  1536.  
  1537.